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(57) An apparatus and method for separating the 
design and implementation of a user interface ("the user 
interface logic") from the design and implementation of 
the functional portion of a software program (the "core 
logic"). The present invention uses an object-oriented 
programming model in which one or more look and feel 
agents (304) act as servers for one or more logic 
objects (302). The look and feel agent (304) controls the 
appearance and behavior of the user interface, while 
logic objects (302) perform the functions of the software 
program. A look and feel agent (304) does not "know" 
what functions constitute the core logic and the logic 
objects (302) do not "know" what the user interface 
looks like or how it behaves. 
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Description 

This invention relates to generating a display on a computer screen and, more particularly, to a method and appa- 
ratus for separating the design and development of user interface functions from the design and development of core 
5 logic functions in a data processing system. 

BACKGROUND OF THE INVENTION 

A software program that is executed by a data processing system must have a way to "talk" to the world outside the 

10 computer system. For example, many software programs include a "graphical user interface" (GUI) that allows a human 
being using the software to give instructions to the software by moving a pointer on a display device with a mouse, a 
touchpad, or the like. The Windows operating system is an example of a software program that interfaces with the user 
via a GUI. ("Windows" is a trademark of Microsoft, Inc.) Another example of an operating system that uses a GUI is the 
OpenLook operating system, which is manufactured by Sun Microsystems. "OpenLook" is a trademark or a registered 

is trademark in the U.S. and foreign countries of Sun Microsystems. Another example of an operating system that uses a 
GUI is the OpenStep operating system, which is manufactured by Next, Inc. "OpenStep" is a trademark of Next, Inc. 

It is desirable for software programs to use GUIs when interfacing with human users because human users find 
GUIs easier to use than traditional character-based computer interfaces. As a rule, however, GUIs are more complex 
than traditional character-based interfaces and take more time and effort to design and program. Thus, GUIs are more 

20 expensive and take more time to develop than non-graphical, character-based user interfaces. 

Generally speaking, software that uses a GUI performs several functions. First, the software must be able to display 
elements on the display device and must be able to adjust the displayed information in response to actions by the user, 
such as the user moving a cursor on the display device with a mouse. This function is an example of a "user interface 
function." Second, the software must be able to perform the actions indicated by the user via the user interface (such 

25 as performing one of a list of optional functions chosen by the user). These functions are examples of "core logic" func- 
tions. Conventionally, software programs have contained both user interface functions and core logic functions. For 
example, within a single software program, a core logic function might make calls to a user interface function that opens 
a new window on the display device. In such conventional programs, the call to the user interface function (where the 
call includes the name of the user interface function) is an integral part of the core logic. 

30 Most software is designed to operate with a single GUI. For example, the Microsoft "Windows" operating system 

expects to operate using a conventional Windows GUI. The GUI used with Windows will always look a certain way and 
there is no provision within Windows to use a different GUI. Modifying a program written to run under Windows to use 
a different GUI would involve extensive modifications to the core logic of the program. In other words, software pro- 
grams written to run under Windows is tied to the Windows GUI and cannot be easily changed. 

35 It is desirable to be able to use any user interface with any software program. If the software program can operate 
with any user interface, the design of the user interface can be changed at will without having to change the core logic 
of the software program itself. Such a scheme would, for example, allow one or more GUIs to be developed independ- 
ently of the core logic of the software program without impacting the design or complexity of the core logic of the soft- 
ware program. In addition, it would be easy to use different GUIs under different circumstances, since the only time 

40 involved in switching between GUIs would be the time required to develop or install the new GUI itself. No changes to 
the core logic of the software program would be required. 

As discussed above, conventional software programs mix user interface functions and core logic functions and 
intertwine the operation of the two types of functions. Another problem arising from the mixing of user interface func- 
tions and core logic functions is that certain computer programmers are expert at writing computer programs for user 

45 interface functions or for logic functions, but not for both. Adding a different user interface to a software program is a 
problem for a computer programmer who is expert in core logic programming but who is not expert in user interface pro- 
gramming. Similarly, if the user interface logic is too closely tied to the core logic, it creates problems for a programmer 
who is expert in user interface programming, but not in core logic programming. 

Conventional software sometimes allows a software program to operate with different user interfaces. This usually 

so is accomplished by re-linking the core logic software so that it is linked to run with a new user interface. Before the 
relinking process can be performed, the core logic must be modified to refer to the new user interface. In other conven- 
tional software, the software is able to access a common "Application Program Interface" (API) layer that allows the soft- 
ware to use one of a plurality of user interfaces. In this case, however, the software program controls which user 
interface it uses and controls the initial selection of that user interface within the API. Thus, the functionality of the core 

55 logic is not completely separate from the choice and functionality of the user interface 

SUMMARY OF THE INVENTION 

The present invention provides an apparatus and method for separating the design and implementation of a user 
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interface from the design and implementation of the functional portion of a software program (the "core logic"). The 
present invention uses an object-oriented programming model in which one or more "look and feel agents" (hereinafter 
"L&F agents") act as servers for one or more logic object clients. A L&F agent controls the appearance and behavior of 
the user interface, while a logic object performs the functions of the software program. A L&F agent does not "know" 
5 what functions constitute the core logic and the core logic does not "know" what the user interface looks like or how it 
behaves. 

In accordance with the purpose of the invention, as embodied and broadly described herein, the invention relates 
to a method of controlling the appearance and behavior of a display device in a data processing system, including the 
steps of: 

10 

defining by a look and feel agent, an appearance of a widget using configuration information that is not a* part of the 
look and feel agent; and 

performing, by a core logic object, a core logic function; 

determining, by the core logic object during performance of the core logic function, that data must be displayed on 
75 the display device; 

sending information from the core logic object to the look and feel agent, the data representing the data to be dis- 
played; and 

displaying, by the widgets of the look and feel agent, the data sent by the core logic object. 

20 BRIEF DESCRIPTION OF THE DRAWINGS 

The objects, features, and advantages of the system of the present invention will be apparent from the following 
description, in which: 

25 Fig. 1 illustrates an exemplary computer system in accordance with a preferred embodiment of the present inven- 

tion. 

Fig. 2 is a representation of an "object world" in a preferred embodiment of the present invention. 

Fig. 3 is a block diagram showing a plurality of logic objects communicating with a plurality of look and feel agents 

of Fig. 2. 

30 Figs. 4(a) and 4(b) are diagrams showing steps performed by an exemplary logic object and an exemplary look and 
feel agent to communicate with a user through a GUI. 

Figs. 5(a) through 5(c) show exemplary functions called by the logic object of Fig. 3 to interface between the logic 

object and the look and feel agent. 

Fig. 6 shows source code for an example logic object 
35 Fig. 7 is a flow chart of exemplary steps performed by a look and feel agent. 

Fig. 8 shows a syntax of configuration information used by the look and feel agent. 

Fig. 9 shows an example of configuration information in accordance with Fig. 8. 

Fig. 10 shows an example of classes of widgets created by the look and feel agent of Fig. 3. 

Fig. 1 1 is a flow chart of steps performed by a first exemplary composite widget 
40 Fig. 12(a) shows an example of a window displayed in accordance with the example configuration information of 

Fig. 9 and the steps of Fig. 1 1 . 

Fig. 12(b) shows an example of a pull-down menu in the window of Fig. 10. 
Fig. 13 is a flow chart of steps performed by a second exemplary composite widget 
Fig. 14 shows an example of a screen display generated in accordance with the steps of Fig. 13. 
4$ Fig. 15(a)-15(c) show an example of a composite widget 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 

The following description is of the best presently contemplated modes of carrying out the invention. This description 
so is made for the purpose of illustrating the general principles of the invention and is not to be taken in a limiting sense. 

I. Operating Environment 

The environment in which the present invention is used encompasses a general distributed computing system 100. 
55 wherein general purpose computers, workstations, or personal computers are connected via communication links of 
various types, in a client-server arrangement, wherein programs and data, many in the form of objects, are made avail- 
able and shared by various members of the system for execution and access by other members of the system. 

Some of the elements of a general purpose workstation computer are shown in Fig. 1 . Fig. 1 shows a processor 
101. which has an input/output ("I/O") section 102, a central processing unit ("CPU"), 104. and a memory section 106. 
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Memory section 106 includes a logic object 302, and a look and feel agent 304 (hereinafter "L&F" agent 114), and a 
composite Widget 306. Elements 302 t 304, and 306 and their uses are discussed below in detail. The I/O section 102 
is connected to a keyboard 108, a display unit 1 10, a disk storage unit 1 12, and a CD-ROM drive 114. CD-ROM drive 
1 1 4 can read a CD-ROM medium 1 1 6, which typically contains programs 1 1 8 and data. A computer display icon 1 22 is 
5 shown on display unit 110. Similar workstations may be connected by a communications path 124 (e.g., an Ethernet 
network) to form a distributed computer system. 

II. A Preferred Embodiment 

10 The present invention is included as a part of Sun Microsystem's L10N Development Kit, version 2.0. The function- 
ality of the LION Development Kit, which currently uses a graphical user interface, is intended to help computer pro- 
grammers "localize" software products by tailoring certain aspects of the software products and manuals to various 
countries in which the software products and manuals are to be distributed. The present invention, however, may be 
used with any software program that interfaces with a human being and is not limited to use with localization programs 

75 or with any particular type of computer software. Moreover, the present invention is not limited to GUIs, but can integrate 
any type of user interface with the logic performing portion of a computer program. For example, the present invention 
can be used to add a text-based user interface to a computer program. 

The described embodiment of the invention is written in the C++ programming language. C++ is an object-oriented 
language and, although the present invention will be described in terms of an object-oriented implementation, the 

20 present invention could also be implemented without using an object-oriented implementation. The described embodi- 
ment utilizes the Solaris operating system. Solaris is a version of the UNIX operating system that is manufactured by 
Sun Microsystems, Inc. Solaris is a trademark of Sun Microsystems, Inc. "UNIX" is a registered trademark in the United 
States and other countries, exclusively licensed through X/OPEN, Ltd. 

Fig. 2 is a representation of an object world 200 in a preferred embodiment of the present invention. The objects of 

25 Fig. 2 are classified into two types: logic objects 102, 104, 107, 108, 112, and 113 and L&F agents 106, 114, 115. 
Object-oriented programming is well-known to persons of ordinary skill in the art and will not be discussed in detail 
herein. In a preferred embodiment of the present invention, objects and agents communicate by "object migration" as 
discussed below. 

In the described embodiment, logic objects provide the functionality of the system by performing localization func- 

30 tions. In this embodiment, localization functions are examples of core logic functions. For example, Fig. 2 shows a logic 
object 102 that performs the functions of "Navigator". The logic objects of Fig. 2 also include: "Dictionary Lookup" 107, 
"Translation Assistant" 112, "Install" 108, and "Glossary" 113. The specific nature of the core logic functions are not a 
part of the present invention and will not be discussed in detail. The present invention is directed to separation of the 
function of the core logic of logic objects from the user interface functions of L&F agent 1 14. This separation allows the 

35 logic objects to operate with L&F agents that implement various user interfaces. 

Fig. 3 is a block diagram showing a plurality of logic objects 102, 1 04 and 1 1 2 communicating with a plurality of L&F 
agents 1 1 4, 1 06 and 1 1 5. Each line 302 of Fig. 3 represents a connection established between a logic object and a L&F 
agent using "object migration," as discussed below. Lines 302 do not necessarily represent separate physical connec- 
tions. Each L&F agent includes a plurality of composite widgets, each plurality represented by respective reference 

40 numbers 306, 308 and 31 0. 

A logic object communicates with a L&F agent via a "Distributed Object Management" (DOM) system 320. This 
system passes objects containing predefined information between the logic objects and the L&F agents. In each L&F 
agent, a "Local Object Manager" (LOM) 330 in the DOM accesses configuration information 320. The LOM 330 then 
initiates composite widgets in accordance with the configuration information. The LOM interfaces with the composite 

45 widgets, which perform GUI functions. Composite widgets 306, 308 and 310 are designed to operate with three different 
GUI's. Motif, OpenStep, and MS-Windows are shown in the Figure as examples. The LOM 330 is the same in agents 
106, 114 and 115. 

In the present invention, multiple logic objects may act together as an individual process or as an individual thread 
within a process. Multiple logic objects may also act independently as separate threads or as separate processes. The 
so system may contain any number of L&F agents, which interface to various GUI's. Respective L&F agents in the system 
may control different respective user interfaces at a given time. Some L&F agents may be on a different network node 
than all or some of the logic objects. 

The following paragraphs discuss L&F agent 114 and logic object 102, although the discussion is equally applica- 
ble to any L&F agent and to any logic object in the system. L&F agent 1 14 is a service provider that handles the user 
55 interface (e.g.. a GUI) for a client (a logic object). It is an important aspect of the present invention that the user interface 
is completely handled by the L&F agent. 

The appearance and behavior of the user interface is entirely controlled by the L&F agent, as described in detail 
below. L&F agent 1 14 is a "service provider for the logic objects. The logic objects interface with L&F agent 1 14 for vis- 
ual feedback, interactive input from a human being, and any other user-related tasks. The logic objects send requests 
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to,L&F agent 1 14 for visual feedback on GUI events that require a user's attention. L&F agent 114 receives interaction 
from a human via the user interface, converts the interaction to a functional request, and sends the functional request 
to an appropriate logic object. Thus, the logic object does not "know" what GUI is being used. 

In the described embodiment, L&F agent 1 14 acts as a single server running on the user's workstation. Similarly, 
5 at least one logic object, such as delivery system logic object 1 02, functions as a window manager in an X Window sys- 
tem. As discussed above, a preferred embodiment of the present invention uses an object-oriented methodology. Spe- 
cifically the implementation may use DOE/DOMF (Distributed Objects Everywhere/Distrfouted Objects Messaging 
Format) to communicate between objects. 

L&F agent 114 creates and accesses a plurality of composite widgets 306. A "widget" is an object representing a 
io display element, such as a requester box. In the described embodiment, the composite widgets of L&F agent 1 14 inter- 
face with Motif, revision 2.2 in accordance with configuration information 320. It should be understood by persons of 
ordinary skill in the art that other user interfaces can be used in place of Motif. For example, the present invention can 
be used with OpenStep, with NextStep, with Windows-95, or with a text-based interface. 

Logic object 102 interfaces with L&F agent 1 14 for the following purposes: 

15 

1 . Physical communication between the agent and the logic object. 

2. Instance name binding. Each display element is considered an "instance" of a type of display object. Logic object 
102 starts the display of a display element by binding a new instance name for the display element to display sym- 
bols stored in as associated configuration information 320. Configuration information 320 is discussed in more 

20 detail in connection with Fig. 9. 

3. Upstream message handling. Besides the instance/name binding, the logic objects sends messages needed to 
build the look of and feel of the objects, such as a list of the choices in a particular data format. 

4. Downstream message handling. In certain implementations a logic object may request a callback (at the time 
that it initiates an object), where the callback is to be performed, e.g., when the user clicks on a choice in a list of 

25 choices. If logic object 1 02 requires a "callback", L&F agent 1 1 4 interfaces its own callbacks registered to the com- 
posite widget layer of L&F agent 1 14. 

5. Managing multiple contexts of logic objects. Each L&F agent can communicate with multiple logic objects. 

6. Define look and feel policy. Because logic object 102 does not have any look and feel policy. L&F agent 114 
defines such a policy from the external configuration information 320 associated with the L&F agent 114. Configu- 

30 ration information 320 is discussed in more detail in connection with Fig. 9. 

Figs. 4(a) and 4(b) are diagrams showing steps performed by the logic object 102 and the L&F agent 1 14. It will be 
understood by persons of ordinary skill in the art that the steps of Fig. 4 are embodied by a CPU, such as CPU 104 of 
Fig. 1 , that executes instructions stored in a memory of the computer system 100. 
35 In step 401 , logic object 102 calls a "configure user interface" routine and passes it a name identifying the config- 
uration information 320. This information is passed to L&F agent 114. 

In step 402, LOM 314 reads and parses configuration information 320. Configuration information 320, which is dis- 
cussed below in more detail, describes a screen layout of the user interface, a list of resources of widgets, and a list of 
reactions of the logic object to the user's actions. Exemplary user actions include pressing a button, selecting an item 
40 in a list, pressing a key, etc. LOM 314 then creates an internal widget list in memory 106 in accordance with the infor- 
mation. In step 404 logic object 102 invokes a function "set_cw_resource" (set composite widget resource). The DOM 
of the logic object 102 migrates this information to the DOM of L&F agent 114. LOM 314 searches its internal "instanti- 
ated" widget list (not shown) for a widget ID specified in the set_cw_resource function. In step 406, LOM 314 invokes 
the proper member function of the proper composite widget and passes the resource data received from the logic object 
45 and the configuration information to the widget. 

After the user indicates that his input is complete, the composite widget passes the user input to L&F agent 114. 
The L&F agent 1 14 notifies the logic object 102. Logic object 102 invokes a look and feel function "get_cw_output" ("get 
composite widget output.") in step 408. L&F agent 1 14 searches its internal "instantiated widget list" in step 410 for a 
widget ID specified in the get_cw_output function. LOM 314 then gets the requested information from the composite 
so widget and, in step 410, returns the information or data to the calling logic object 102. 

Fig 4(b) shows an alternate embodiment of the present invention employing "call-backs" between the L&F agent 
and the logic object. In this embodiment, steps 420-432 are performed instead of steps 406-412 of Fig. 4(a). In step 
420, logic object 102 calls a "bind -callback" function. The DOM of logic object 102 communicates the name of the logic 
objects callback function to the agent 114, which "binds" the logic object's call back function name to the name of an 
55 existing callback function in the agent. 

Thereafter, whenever the user performs an action that has been defined in the L&F agent to invoke the agent's call- 
back function the DOM of the agent will also notify logic object 102 that a callback has occurred (see step 426). The 
logic object can then request the user input from the L&F agent 1 14, as discussed above in connection with Fig. 4(a). 

Fig. 5 lists the calls that logic object 102 can issue to communicate with L&F agent 114. These calls include: 
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bind_cb, set_cw_resource, set_cw_input, and display-GUI. 

Fig. 6 shows source code for an example logic object. The logic object calls "config_ur at line 602; calls 
"bind_callback" at line 604, and calls set_cw_resource at lines 606. 

Fig. 7 is a flow chart of exemplary steps performed by an L&F agent. Initially, the L&F agent reads and parses con- 
s figuration information 320 in step 702. In step 704, in accordance with the configuration information, the L&F agent 
instantiates composite widgets required to implement the GUI to be used. 

If, in step 706, the L&F agent receives a set_cw_resource request, the L&F agent searches its Instantiated widget 
list" in step 708 for a widget that performs the function in the request. In step 710, the L&F agent invokes the proper 
member function of the composite widget. The resource data in the request is passed as an argument to the invocation 
10 of the member function. 

If, in step 712, the L&F agent receives a get_cw_output request, the L&F agent searches its "instantiated widget 
list" in step 714 for a widget that performs the function in the request. In step 716, the L&F agent invokes the proper 
member function of the composite widget and receives data from the composite widget. In step 718, the L&G agent 
returns the received data to the logic object. In step 720, the L&F agent notifies the logic object of any user action that 
is requires a reaction from the logic object. 

Fig. 8 shows a syntax of configuration information 320. As shown in Fig. 8 at 702, the configuration information pref- 
erably has three sections: a LAYOUT section, a RESOURCE section, and an ACTION section. Each section starts with 
a keyword (LAYOUT, RESOURCE or ACTION) followed by a colon. The LAYOUT section defines the type of the widgets 
used. The LAYOUT section includes one or more layout statements, each of which includes a widget ID, a class of the 
20 widget ID, either another widget ID or a widget tree. Fig. 10 shows exemplary widget classes. An example widget tree 
might look like: 

action 1(\ 

25 action2 (act2_l , act2_2),\ 

action3, \ 
action4 (\ 

30 act4- 1 , act4_2, act4_3 (\ 

act4_3_l)\ 
)\ 

). 



The widget name is more frequently used as configuration information than is the widget tree. The widget tree 
above is used by LOM 314 to construct a pull-down menu. For example, the delivery subsystem of Fig. 12(b) has a 
40 menu button "File" with two subcategories, "deliver" and "quit". Note that "ROOT" is a reserved word in the configuration 
information 320 representing the root in the widget tree in the configuration information. Whether the widget class 
"actionMenuW" is rendered as a pull-down menu button or not is decided by the widget itself. 

The RESOURCE section of configuration information 320 has one or more resource statements of the form: 
widgetjd. resource: value 

45 For example, for "load.label: Load Glossary" the action-Menu "load" has a label "Load Glossary". 

The ACTION section of configuration information 320 defines actions to be taken upon actions by the human user. 
Some widgets may produce events which should be handled by the logic or any trigger value changes of other widgets. 
Logic may also expect results from widgets as it handles the event. These functionalities can be expressed in the fol- 
lowing rules - 

50 

action_widget_id: callback ID(output_widget_id_l , 

output_widget_id_2,„.) 
& or 

action_widget_id: <affected_widget_id.resource: value> 
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The first rule tells L&F agent 114 that when an event comes from "action_widget_id". the event handler, "call- 
backlD", from the logic should be invoked with outputs from "outpuM/vidgetJd" as arguments. Note that 
output_widget_ids are optional. The logic also needs to register the actual call-back function to L&F agent 1 14. 
5 With the second format the source of the affected widget is set to the specified value. It is legal to specify more than 

one event handler as well as affected widgets. The invoking sequence depends on the appearance in the configuration 
information. 

Fig. 9 shows an example of configuration information in accordance with the syntax of Fig. 8. The configuration 
information includes a LAYOUT section 902, a resource Section 904, and an action section 906. 
w As discussed above, the LOM of L&F agent 114 instantiates composite widgets in accordance with configuration 
information 320. Fig. 1 0 shows classes of composite widgets used that can be created by LOM 31 4 to be used with the 
Motif user interface. The classes of Fig. 10 are defined as follows: 

- CWObj: 

is The CWObj class is the top of the Composite Widget Set tree. The CWObj class is the only class with no super- 
class. The CWObj class is defined as pure virtual class, it is only to be inherited by the every classes in Composite 
Widget. 

CWMain Frame: 

20 The CWMainFrame class provides the frame with menu bar and message area. The CWMainFrame must be cre- 
ated as base window for all logic objects. 

- CWTextMsgDF: 

This class contains message area, textf ield and confirm buttons. It corresponds to PromptDialog Widget. 

25 

- CWPullMenu: 

The CRPullMenu dass provides a PullDown menu, label and textfield area. 
CWMenu: 

30 The CWMenu class is to add extra menu to the menubar part of the CWMainFrame class. The CWMenu class con- 
sists of Pulldown menu, cascade buttons, and a label. 

CWBrowser: 

It contains two Selection Box Widgets with two buttons attached to each of the Boxes. It also contains three Label 
35 Widgets. The Label widgets are used for the title of the two selection widgets, the label for the left selection widget, 
and the third is for the right selection widget. 

CWHierarchyBrowser: 

Subclass of CWBrowser. In addition to CWBrowser class, CWHierarchyBrowser class provides the hierarchical 
40 data handling scheme listed in the Selection Box. It takes a tree structure containing multiple objects as a initializa- 
tion input, and returns a list of objects being selected. 

CWListBrowser: 

Subclass of CWBrowser. In addition to CWBrowser class, CWListBrowser class provides the list data handling 
45 scheme displayed in the Selection Box. It takes a list structure containing multiple objects as an initialization input, 
and returns an objects being selected. 

CWMessage: 

MessageDiatog class. This class contains message area and confirm buttons. 

50 

- CWTextEdit: 

Multi line editable text class. 

• CWSelRadioD: 

55 This class consists of dialog widget that contains message area, radio buttons for selections, and confirm buttons. 
It will have BulletinBoard for the body parts. 

Fig. 1 1 is a flow chart of steps performed by a first exemplary composite widget. Fig. 1 3 is a flow chart of steps per- 
formed by a second exemplary composite widget From the viewpoint of logic object 102, the composite widgets of Figs. 
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11 and 13 perform exactly the same function: to display a list of choices and to allow the user to select one of the 
choices. In fact, however, the first composite widget implements a graphical user interface, while the second composite 
widget implements a text user interface. The difference between the two composite widgets is totally transparent to logic 
object 102. The LOM of L&F agent 1 14 initially instantiates one or the other of the objects of Figs. 1 1 and 13, in accord- 
5 ance with configuration information 320. 

Display area 1202 of Fig. 12 is generated by the steps of Fig. 1 1 , which implements a graphical user interface. In 
step 1102, the composite widget receives from the LOM arguments for the member function invoked by the LOM. In 
step 1104, the member function outputs each choice with a small circle next to it. In step 1106, the member function 
allows the user to select one of the choices with, e.g., a mouse, and fills in the circle next to the selected choice. In step 
10 1 108, once the user has made a final selection, as indicated by, e.g.. double clicking the mouse button, the member 
function returns the user's choice to the LOM. 

Display area 1402 of Fig. 14 is generated by the steps of Fig. 13, which implements a text user interface. In step 
1302, the second composite widget receives from the LOM arguments for the member function invoked by the LOM. In 
step 1304, the member function outputs each choice to the display screen. Note that the second composite widget does 
is not interface with a windowing system, as does the composite widget of Figs. 1 1 and 12. In step 1306, the member 
function allows the user to select the choices by moving a cursor virtually using, e.g., keys on a keyboard. Each choice 
is highlighted as the cursor passes over it. In step 1 308, once the user has made a final selection, as indicated by, e.g., 
hitting the "return" key on the keyboard, the member function returns the user's choice to the LOM. 

Figs. 15(a) and 15(b) show an example composite widget. The composite widget shown is the widget to generate 
20 the main window in a windowing subsystem. Thus, the widget generates a menubar, a window body, and a footer area. 

As will be understood by persons of ordinary skill in the art, a system in accordance with the present invention may 
contain any number of widgets in an L&F agent, and those widgets may perform any functionality required to generate 
a desired user interface. As discussed above, the widgets may implement any type of desired user interface, such as a 
graphical user interface or a text user interface. The type of user interface implemented is transparent to any logic 
25 objects interfacing with the L&F agent. 

Several preferred embodiments of the present invention have been described. Nevertheless, it will be understood 
that various modifications may be made without departing from the spirit and scope of the invention. 

In describing the preferred embodiment, a number of specific technologies used to implement the embodiments of 
various aspects of the invention were identified and related to more general terms in which the invention was described. 
30 However, it should be understood that such specificity is not intended to limit the scope of the claimed invention. 

Claims 

1 . A method of controlling the appearance and behavior of a display device in a data processing system, including the 
35 steps of: 

defining, by a look and feel agent, an appearance of a widget using configuration information that is not a part 
of the look and feel agent; and 
performing, by a core logic object, a core logic function; 
40 determining, by the core logic object during performance of the core logic function, that data must be displayed 

on the display device; 

sending information from the core logic object to the look and feel agent, the data representing the data to be 
displayed; and 

displaying, by the widgets of the look and feel agent, the data sent by the core logic object. 

45 

2. The method of daim 1, further including the step of returning control by the look and feel agent to the core logic 
object when the look and feel agent receives a callback from the widget. 

3. The method of claim 1, wherein the configuration information has a layout section, a resource section, and an 
so action section. 

4. The method of claim 1 , wherein the sending step includes the step of migrating objects between the core logic 
object and the look and feel agent. 

55 5. The method of claim 1 , further including the steps of: 

defining, by a second look and feel agent, a second widget using second configuration information that is not 
a part of the second look and feel agent and that is different from the first configuration information. 
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6. The method of claim 1 , wherein the configuration information corresponds to a first user interface. 

7. The method of claim 5, wherein the second configuration information corresponds to a second user interface. 

c 

10 
15 
20 
25 
30 
35 
40 
45 
SO 
55 
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Composite Widget 



402 



Composite Widget 
Configures Interface 
in Accordance With 
Specified 
Configuration File 



401 



Object Migration 



Logic Obj ect 

"Configure User Interface" 
(Config Filename, Version) 



(Config Filename, Version) 



Done 



r 



Composite Widget 
Creates GUI Display and 
Gets User Response 



406 



410 ^_ 

Composite Widget 
Sends User Input to 
Logic Object 



404 



Object Migration 



(Widget ID, Type, Data) "Set_CW_Resource" 

(Widget ID, Type, Data) 



Done 



408 



"Get_CW_Output n 
(Widget ID, Type, (Return Value:Data)) 



Object Migration 



(Resource ID, Type) 



User Input 



412 



Perform Logic 
Operations Using User Input 



FIG. 4(a) 
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114/316 



Composite Widget 
422 



<Steps> 

o o o 



102 

420 ^ 

Logic Object 
"bind-callback" Function 



Binds Composite 
Widget Function to 
Logic Object 
Function 
(b)< Sets Up Callback 



(Logic Object Function Name) 



Composite Widget 
Creates GUI Display; 
User Input Creates 
Callback 



426 



430 

Composite Widget 
Sends user Input to 
^Logic Object 



Done 



424 



"set cw resource" 

(Widget ID, Type, Data) 



(Widget ID, Type, Data) 



Callback 



428 



"get cw output" 

(Resource ID, Type 
<Return Value; Data)) 



Resource ID, Type 



User Input 
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Perform Logic 
Operations Using User Input 



FIG. 4(b) 
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Agents/Brokers Interface 

Look&Feel Agent 

The interface LnFAgent is defined as follows in IDL 

interface LnFAgent { 
LnFAgent ( 

in const char*, // configuration filename 

in const char* = "". // version number 
in const char* = "C", // locale 

); 

*LnFAgent(); 
void bind_cb( 



in const char*, 
in CallbackType, 
in void* 



); 



void set_cw_resource( 



in const char*, 
in cw_resource, 
in const char* 



); 



void set_cw_resource( 



// callback ID specified in C 
// callback routine 
// callback data 



// widget instance name 
// resource name 
// value 



in const char*, // widget instance name 

in CW — Resource, // resource name 
in int //value 

); 

void set_cw_input( 



FIG. 5(a) 
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in const char*, 
in int 



); 



void set_cwjnput( 



in const char*, 
in const char* 



); 



void set_cw_input( 



in const char*, 
in CW Data 



); 



void set_cwjnput( 



in const char*, 
in CW Data List 



); 



// widget instance name 
// value 



// widget instance name 
// value 



// widget instance name 
// value 



// widget instance name 
// value 



void display_gui( 

(void)O(void) = NULL // logic routine 

); 



}: 



constructor and destructor 



LnFAgent() and LnFAgentQ are constructor and destructor 
respectively. LnFAgent() reads the configuration file whose name 
is the concatenation of the two arguments, "filename" and 
"version", and creates proper composite widgets. 

set__cw_resource() and set_cw_input() 

setResource() sets a resource of a widget instance. Depending 
on the widget type and resource type, set_cw_resource() may 
take more than two arguments. 



bind_cb() 



set_cw_input() initializes a widget with necessary information. 



From the configuration file Look&Feel agent only learns the IDs 
of callbacks which should be invoked as an event occurs. We 
still need a mechanism to locate the callback address by its ID. 
bind_cb() serves such purpose. If the first argument 



FIG. 5(b) 
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matches the callback ID in the configuration file, the handler 
specified in the second argument is called. 

The type of the handler, "CallbackType", is defined as 



int 0(LnFAgentMessageType. void* clnt_data) 



The second argument, "clnt_data", is the third argument passed 
in bind_cb(). 

The type of the first argument "LnFAgentMessage" is a pointer to 
a struct with two members - 

typedef struct { 

const char* widgetID; 
void** result; 

} *LnFAgentMessage; 

The first member identifies where the event comes from. The 
second member contains the outputs as specified in the 
configuration file. 

The event handler returns 0 if no error. happens. 
displayjguiQ 



The Look&Feel agent may start to display GUI. The logics wait 
until the window is destroyed. 



FIG. 5(c) 
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logic.cc 



#inciude <stdlib.h> 
#include <unistd.h> 
#include <iostream.h> 

#include <string.h> 
#include "qlist.hh" 
#include "LnFAgent.hh" 

const, char* MYCONFIG = "xxx.conf '; 
LnFAgent* myagent; 

void 

myErrorHandler(void* ( const char* msg) { 

cerr « "In myErrorHandler : message is: " «msg « endl; } 

void 

myExitHandler(void* msg) { 

cerr « "In myExitHandler : message " « (char*) msg « endl; } 

int 

myCallback (void*) { cerr « "Callback ..." « endl; 
static int i = 0; 
i = 1 - i; return i; } 

int 

quitCB(void*) { cerr « "In QuitCB, Exit 0" « endl; exit(0); 
r not reached */ return 0; } 

int 

actCB2(void*) { 

cerr « "In actCB2 and sleep" « endl; 

myagent->set_cw_resource( M ROOr\ "CWmessage", "hi there"); 
return 0; 



main() { 




myagent = new LnFAgent (myErrorHandler); 



604 



myagent->config_ui (MYCONFIG); 




myagent->bind_calIback( n deliverCB M f myCallback, NULL); 
myagent ->bind_callback ("quitCB", NULL); 
myagent->bind_callback ("actCB2 f, l actCB2, NULL); 



Example Logic Object 
FIG. 6(a) 
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// construct medium list 

static char* pp[ ] = { "CD-ROM". 'TAPE". "EMAIL". "FILE". NULL}; 
static char" qq[ ] = { "Vdev/rstO". "/dev/rstl". "". "", NULL }; 
static int rr[ ] = { 1 , 1 . 1 , 0. NULL }; 
int i; 

QList<RadioList> qlist; 
QListlter<RadioList> qit (qlist); 

for (i=0; pp[i] != NULL; i++) { 

RadioList * r = new RadioList; 
r->label = strdup(pp[i]); 
r->media_path = strdup(qq[i]); 
r->is_read_only = rr[i]; 
qit.ins_next(*r); 



myagent->set_cw_resource("menu1". "CWInput", (CWData*) &qlist); 

CWString s1[] = { 
{"OS"}, 
{"Windows"}, 
{"AnswerBook'7, 
{"dinner"}, 
flunch"}, 
{"hi"}, 
{0} 

}; 

QList<CWString> slist; 
QListlter<CWString> iter_slist(slist);; 



myagent->set_cw_resource("browser1", "CWInput", (CWData*) &slist); 
myagent->display_ui(myExitHandler, "It's over"); 




for(i = 0 ; sl[i].get_value() !=0 ; i++) { 
iter_slist.ins_next(sl[i]); 

} 




608 



Example Logic Object 
FIG. 6(b) 
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700 



702 



Read and parse the 
configuration information 



704 



Instantiate composite 
widgets in accordance with 
parsed configuration 
information 



714 



Search for the 
corresponding 
widget ID from the 
internal widget list 



Get the internal 
data/information 

from the 
composite widget 



T 



716 




Return the data to 
the logic object 



718 



720 



710 



708 



Search for the 
corresponding 
widget ID from the 
internal widget list 



Invoke the proper 
member function 
of the composite 

widget. The 
resource data is 

passed as an 
argument to the 
invocation of the 
member function. 



Notify the logic 
object of any user 
action that requires 
a reaction from 
the logic object 



FIG. 7 
Look and Feel 
Agent (Local 
Object 
Manager) 
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Syntax rules used in a confiq file: 



802 




config_fi!e:: 

LAYOUT layout_section RESOURCE resrc_section ACTION 
act_section 

layout_section:: 

layout_statement... 

layout_statement: : 

WidgetlD.WidgetCIass: widget_idjist 

widgetjdjist:: 

Widget ID / widget_tree 

widget_tree:: 

WidgetiD(widgetJd_list t ...) 

resrc_section:: 

[ resrc_statement... ] 

resrc_statement:: 

WidgetlD.ResourcelD: Value 

action_section:: 

[ act n_statment... ] 

action_statement:: 

WidgetID[.ActionType]: action 

action:: 

single_action I mu!ti_action 

sing!e_action:: 

CallbackID I <resrc_statement> I if_action 

inaction:: IF (CallbackID) THEN action [ ELSE action ] 

multi_action:: { action... } 



FIG. 8(a) 
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WidgetID:: string 
WidgetClass:; string 
ResourcelD:: string 
Value:: string 
ActionType:: string 
CallbackID:: string 

1 . [x] means x can be omitted 

2. x... means x can be repeated 

3. x/y means x or y 

4. "LAYOUT, "RESOURCE" and "ACTION" are pre-defined keywords 

5. "ROOT" is a predefined WidgetID 



FIG. 8(b) 
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902 



xxx.conf 

Delivery Subsystem Configuration File 
Words in upper case are pre-defined keywords, 
syntax: 
LAYOUT: 

parentWidgetlD.widgetClass: [ widgetjd I 
widget_id(subwidgetlD,..) ] 

RESOURCE: 

widget_id. resource: value 
ACTION: 

widgetjd: [ calIbackID(widget_id.„) I 

<widget_id. resource: value> ] 



action 1(\ 

action2(act2_1 , act2_2), \ 

action3, \ 

action4(\ 

act4_1, act4_2, act4_3(\ 
act4_3_1)\ 




904 



) 

ROOT.actionW: 

ROOT.shortExclusiveListW: 

ROOT.browserW: 



helpl 

menul 

browserl 



RESOURCE 

action LCWIabel: 
action2.CWIabel: 
action3.CWIabel: 
act2_1 .CWIabel: 

# helpl. CWIabel: 

# ROOT.CWmessage: 

# menul .CWIabel: 

# browserl .CWIabel: 



Deliver 

Change Msg Area 

QUIT 
ACT2_1 
HELP ME 
mmmmmm 
Media 

Deliverables 



#INPUT: 

# menul: 

# browserl : 
# 



dataList 
dataTree 



Example Configuation Info 
FIG. 9(a) 
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#OUTPUT: 

# menul: data 

# browseri: dataList 
# 

# p.s. Showing INPUT and OUTPUT sections here is for your information 

only. Users can not change the pre-defined input and output types of 
906 the composite widgets 

L&F Agent will not recognize INPUT and OUTPUT commands. 

'ACTION 

act2_1: IF (deliverCB) THEN \ 

<ROOT.CWmessage: hello> 

act2_2: IF (deliverCB) THEN \ 

<ROOT.CWmessage: hello> \ 
ELSE { <ROOT.CWmessage: world> actCB2 } 
action3: quitCB 
act2_1 : quitCB 



Example Configuration Information 
FIG. 9(b) 
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CWObj 





CWMainFrame 






CWTextMsgD 






CWPullMenu 






CWMenu 






CWBrowser 






CWRowColumn 






CWMessage 






CWTextEdit 






CWSelRadioD 






CWShortList 



CWHierarchyBrowser 



CWListBrowser 



Composite Object ClassHierarchy 
FIG. 10 
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Composite Widget #1 (Lets User select one of a group of choices) 

(Windows version) 



1102 

Receive from the LOM 
arguments for the member 
function of this object 
invoked by the LOM 



1104 



In current widow, output 
each choice with a small 
circle next to it (see Fig. 12) 



1106 



Let user select one of the 
choices and fill in the circle 
next to the user's choice 



member 
function 



1108 



Once the user's choice is 
final (e.g., when the user 
presses the right mouse 
button or double clicks), 
return the user's choice to 
the LOM 



FIG. 11 
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110 



Kit Deliver 



File 



Media Selection 



O Floppy (/dev/rfdO) 
O Floppy (/dev/rfdOa) 
O Floppy (/dev/rfdOb) 

Q F loppy (/dev/rfdOpi. J 

OTape (/dev/rst12) 
OTape (/dev/rst20) 
OTape (/dev/rst28) 
OTape (/dev/rst4) 
® email 

OFILE Q 



□c 



Help 



Location: 

Select Subcomponent: 



RDDALL7 

TransactionLog/ 

BUILDPKG/ 



Add Below 



Selections to Deliver: 



Remove 



FIG. 12(a) 
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FIG. 12(b) 
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Composite Widget #2 (Lets User select one of a group of choices) 

(Text version) 



1302 



Receive from the LOM 
arguments for the member 
function of this object 
invoked by the LOM 



1304 



On view screen, output 
each choice and highlight 
default choice (see Fig. 14) 



1306 



Highlight each choice as 
the user moves the cursor 
over it 



> 



member 
function 



1308 



Once the user's choice is 
final (e.g., when he hits the 
return key), return the user's 
choice to the LOM 



FIG. 13 
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110 



Move cursor to make choice and press enter- 
Floppy (/dev/rfdO) 
Floppy (/dev/rfdOa) 
Floppy (/dev/rfdOb) 
Floppy (/dev/rfdOc) 
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Tape (/dev/rst20) 
Tape (/dev/rst28) 
Tape (/dev/rst4) 



email 



File 



enter filename> 



FIG. 14 
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// 

// CWMainframe.h: This is the Mainframe window for all subsystems. , 

// It contains, menubar, body and footer message area. 

// Resources that you can change is only for Form Widget. 

// (Resources for Form widgets should be specified from the 

// children of Form Widget) 

#ifndef_CWOBJ_CWMAINFRAME_HH 
#define_CWOBJ_CWMAINFRAME_HH 
#incude "CWObj.hh M 
include "MSNString.hh" 

struct CWMainframeP ; // forward declaration 
struct PopupData; 

#include "qlist.hh" 

struct menuTree{ 

M8NString label; //label string 

M8NString mnemonic; //label mnemonic 

H8NString accelerator; //accelerator 
M8NString acceleratorText; //acceleratorText 
void (*cb) (void*); //cb to be registered 

// — define your own type 

void * cb_data; //call_data added 9/14/94 

static const int op_id; // 

static MenuTree* decode(char* s, char*& to) { return NULL; } ; 
void encode(char*& buf, int& len) const {}; 

}; 

enum Popup_Status_mode {Ok, //ok btn pressed 

Cancel //cancel button pressed 

}; 

class CWMainframe : public CWObj { 
public: 

CWMainframe(const char *) ; //Useninstance name 

-CWMainframeO ; 

void instantiate_help_panel () ; 

void open_help () ; 

void close_help () ; 

void write_help_text( const M8NString&) ; 
void create _pulldown(QList<MenuTree>&) ;//User:cb registration will be down 

// inside here.. 

// User use this to add pulldown 
\ // menu like "File" 
// The methods which override CWObj methods. 
XMApplicationShell *get_toplevel() ; 

Composite Widget 
FIG. 15(a) 
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XMObject *get_parentContainer(); 

void set_right_footer_messagefl18NString &) ; 

void setJeft_footer_message(M8NString &) ; 

void set_frameTffle(l 1 8NString &) ; 

//popup panels for warning/text entries.////////////////////////////// 
void set_okpopdown(PopupData *); 
//use this for popping up any warning messages. 
//Only has OK button 

void popup_warning(I18NString &) ; 

//use popup_prompt when you want user to type 

//in the entry such as file name 

//Has both OK and Cancel button 
void popup_prompt(H8NString &); 

void set_popupfield_content(char *) ;//CW only 

void popdown_prompt() ; //call this to popdown the popup 

void reg jrompt_ok_cb(void(*cb)(void*), void *client_data) ; 

void reg jrompt_cancel_cb(void(*cb)(void*), void 

*client_data); 

H8NString * get_prompt_content() ; //output 

//use this to display error message 
//Only displays OK button 

void popup_error(H8NString &) ; 

//Working(busy) Popup////////////////////// 
// NO button 

// Popdown when process is complete 

///////////////////////////////////////// 

void popup_working() ; 

void popdown_working(); 

//Question Popup//////////////////////////////// 

//use this to ask user a question 

//Has both OK and Cancel button 

void popup_question(H8NString &) ; 

void reg_question_ok_cb(void(*cb)(void *), void *client_data) ; 

void reg_question_cancel_cb(void(*cb) (void *) , void 

*client_data) ; 

void popdown_question(); 
//used only in CW 

void set_status(Popup_Status_mode t PopupData *) ; 

//return if user selected OK or cancel btn 
Boolean get_status() ; 



Composite Widget 
FIG. 15(b) 
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//use this button if you want to give some 
//friendly info to the user 
//Has OK button 

void popup_info(H8NString &) ; 

//Selection Popuptlllllllt/ItllllllllllllltlllMIIIIfll 

//list selection choices 

// contains OK and Cancel buttons 

void popup_seIection(QList<M8NString> &) ; 

void reg_select_ok_cb(void(*cb) (void *) , void *client_data); 

void reg-se!ect_canceI_cb(void(*cb) (void *), void 

*client_data) ; 
void popdown_se!ection() ; 

void set_selectedValue (XmSelectionBoxCallbackStruct *) ; 

//CW use only 
H8NString * get_selectedltem() ; 

//DoubleTextf Popuptlll/IIIIlIIIlIIUI/tilllUIIIIIimuilfllt 

II Two input area : use it for file and directory type of inputs 

// It comes with cancel and ok btn 

//You can set up message area using set_msgBody(M8NString &) 
void pop_doub!eTextf(QList<M 8NString> &) ; 

void popdown_doubleText(); 
void reg_doubletext_cancel_cb(void(*cb) (void*) , 

void *client_data); 
void reg_doubletext_ok_cb(void(*cb) (void*) , 

void *client_data) ; 
void set_msgBody(H8NString &) ; 

QList<M8NString> * get_doubleFieIds() ; 



Composite Widget 
FIG. 15(c) 
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//CWFilePick////////™ 

void reg_frie_canceI_cb(void(*cb) (void*) , void *client_data) ; 

void reg_file_ok_cb(void(*cb) (void*) , void *client_data) ; 

void popup_fiiepick () ; 

void popdown_filepick () ; 

void set-default_path (H8NString &) ; 

I18NString * get_$eIection() ; 

private: 

CWMainframeP *p; 

void set_menu Items (QListlter<MenuTree>, void*) ; 
void instantiate_prompt_paneI(); 
void instantiate_question_panel() ; 
void instantiate_doubIeTextf() ; 
void instantiate_sei_box() ; 



#endif 



// CWOBJ CWMAIN FRAME HH 



Composite Widget 
FIG. 15(d) 
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Configures Interface 
]n Accordance WHh 
Specified 
Configuraffon File 



401 



ioate Objgg j 

"Configure User Interface" 
(Config Filename, Vsrefon} 



Object Mfgratian 



(Conflg Filename, Version) 



Done 



404 



Object firfigrattan 



{Widget ID, Type, Data} "Sel_CW — Resource" 

(Widget ID, Type. Data) 



Composite Widget 
Creates GUI Display and 
Gets Ussr Response 

x — 

406 



410 

Composite Widget 
Sends User Input to 
Logic Object 



Done 
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"Get_CW_Outptrf r 
(Wfdget ID n Type, (Return Inns: Data)) 



Object Migration 



(Rg&ourc© ID, Type) 



User input 



412 



Perform Logic 
Operations Using User Input 



FIG. 4{a) 
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Done 
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"set cw resource" 
JWldget tD, Type, Data) 



(Widget fD, Typ&, Data) 
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Callback 
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Sends u&©f Input to 

Logic Object 432 
v ^ User Input ^ 

Perform Logic 
Operations Using User Input 



FIG. 4(b) 
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Agents/Brokers Interface 

Look&Feel Agent 

The interface LnFAgent is defined as follows in [DL 

interface LnFAgent { 
LnFAgent ( 

i n c&n st cha r & , (} config u ratf on fi lena me 

in const char* = m \ fi version number 
i n con st cha r* = *C" , // locale 

>; 

'LnFAgerrtQ; 
void bind_cb( 



In const char*, fi callback OD specified In C 

In CallbackType, // callback routine 
fn void* // callback data 



void set_cw_resource( 



In const char*, 
fn cw_resource, 
in const char 0 

)\ 

void &fit_cw_resource( 



//widget instance name 
// resource name 
// vabe 



In const char*, // widget instance name 

in GVV_Re$ource, fi resource name 
in int // value 



); 

void sef_dvO n P u ^( 



FIG. 5(a) 
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in const char*, 
ir> Int 

void seLCwJnputf 



// widget instance name 

// ValU© 



to const char*, 
in const char* 

); 

void sei_cwjnput( 



// wfcfgei instance name 
// value 



In const char*, 
In CW_Data 

); 

void set_cwjnput( 



//widget Instance name 
// value 



in cons! char*. 



//widget instance name 



in GW_Datalist // value 

void display quit, 

<voldX*Xvocdl ~ NULL // logic routine 

)i 



LnFAgent(> and Inf AgentQ are constructor and destructor 
respectively. LnFAgentQ reads the configuration file whose name 
is the concatenation of the two arguments, "filename 11 and 
"version", and creates proper composite widgets. 



&et_cw_resourceO and &&t_cw_input() 



setResourcsQ sets a resource of a widget tnstance. Depending 
□n the wodget type and resource type, set_cw_resource{) may 
take more than two arguments. 

set_cwjnput() initializes a widget with necessary information. 



From the configuration fife Look&Faef agent onJy learns the IDs 
a1 callbacks which should be invoked as an event occurs. We 
still need a mechanism to locate the callback address by its ID, 
blnd_cb() serves such purpose. If the first argument 



constructor and destructor 



hind_cb() 



FfG. 5(b) 
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matches the callback ID in the configuration file, the handler 
specified In the second argument is called. 

The type of the handler, "CallbackType", la defined as 



int OfLnFAgentMessageType, void* clnt_date) 



The second argument, "clnt_data", is the third argument passed 
in btnd_cb{), 

The type of the first argument ,, LnFAgentMessage ,, is a pointer to 
a struct with two members - 

typedef struct { 

const char* widgetID; 
void*" result; 

} "LnFAgentMessage; 

The first member identifies where the event comes from. The 
second member contains the outputs as sp^crfisd m the 
configuration fife. 

The event handler returns 0 if no error happens. 



Th© Look&Feel agent may start to display GUI, The logics wait 
until the window is destroyed. 



FIG. 5(c) 
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logic, cc 



#include <stdlib,h> 
#lndude <unlstd.h> 
#rnclude <icsfraajuh> 

^include <string.h> 
#include "qlist.hh 1 ' 
ffindude "LnFAgenthh" 

const, char* MYCONF1G - "xxx.conf '; 
LnF Agent* myagenf; 

void 

myGrrorHgincfJer(void ,, l const char* msg) { 

cerr « "In myErrorHandler : message is: " «msg << endl; } 

void 

myExitHandferfvoid* mag){ 

cerr <<z "In myExltHandler : message " « (chaO rnag «endl; } 

int 

myCallback (void^) { cerr « "Callback ..." « endl; 
static- int 0; 
i = 1 - i; return i; } 

int 

qu5tCB(void w ) { c©rr « 1, Jn QuitCB. Exit 0" « endl; exii(O); 
t not reached V return 0; } 

Int 

actC82{vo3d*> { 

cerr « In actCB2 and sleep" « endl: 

myagent->set_cw_resource( H ROOT\ "CWmes^age", ,l hi there"); 
return 0; 



main() { 




rnyagent = new LnF Agent (myErrorHandler); 



604 



myagenfc->configjji (MYCONFIG); 




myagen^>bcnd_caHhacKC'deliverCS ,, 1 myCallback, NULL); 
myage n t -> b ind_cal Iba ck fq u if CS", NULL); 
myagent->bind_calEback( ,; actCB2 ,f , actCB2, NULL); 



Example Logic Object 
FUG, 6(a) 
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// const ructf mediirm Hat 

Static char* pp[ J = { "CD-ROM". "TAPE", "EMAIL", "FILE", NULL }; 
static char* qq[ j - { "/dev/ratO", "/dev/rsf T. "", "". NULL }; 
static inf rif ] = { 1 > 1 , 1,0. NULL }; 
int i; 

QList^RadioLisfc* qllat; 
QLIstUer<RadioLfet> qit {qiist); 

for <i*0; pp[IJ l= NULL; K+) { 

Radiotist " r = new RadioList; 
r-> label - strdup{pp[i]); 
r->medoa_path = strdup(qq[l]); 
r->is_nead_onlly = rrfj]; 

qlUnsjniextCr); &os 

myagent^set^cw^eaouroeC'menul", "CWInpuf, (CWData*) &ql3st): /* 

CWString s1[] - { 
{"OS 1 }, 
{"Windows"} , 
{"AnawerBook"K 
{"dinner"}, 
{"lunch"}-, 

cm. 

): 

Q List* CWString > aSist; 

Q Ustlt©r<C WStri ng> it©r_slis»{s list) ; ; 

fcr{5 *= 0 ; sl[iJ,geS_vfilue() NO ; 1+4) { 50$ 
iter_s[ist, ins_next{s l[i]) ; / v 

xnyagent^sa^cw.resourcsC'brDwsed". "CWInput", (CWDeta*) &sllsO; 

myagent->display_ui(myExitHand1er. "It's over"); 



Example Logic Object 
FIG. 6(b) 
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7Q0 



702 



Read and parse the 
configuration information 



704 



Instantiate composite 
widgets in accordance with 
parsed configuration 
information 



714 



j: 



Search for the 
corresponding 
wtdgeE ID from the 
internal widget tist 



Get the internal 
data/information 

from the 
composite widget 




708 



Search for the 

corresponding 
widget ID fr&rn the 

Internal widget lEst 



Return the data to 
the logic object 



718 



720 



710 



T 



Invoke the proper 
member function 
of the composite 

widget. The 
resource data is 

passed as an 
argument to the 
invocation of the 
member fun eEion- 



Notify the logic 
objecl off any user 
action that requires 
a reaction from 
the logic object 



FIG. 7 
Look and Feel 
Agent (Local 
Object 
Manager] 
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Syntax rutes used in a. confta filet 
302 

config^file:: 

LAYOUT layout_SBCtk>n RESOURCE res rejection ACTION 
act_sect!Dn 

layout_sectton;; 

layout_statsment. . . 

Iayc'ul_statemerit;; 

Widg etl D . WidgetClass: widgetjef Jist 

widgeljdjist;; 

W!d getl D / wid g et_tree 

widgeMree:: 

Widgetl □ (wid getj d Jiat, _ . .) 

resrc_section:: 

[ resrc_statement-. ] 

r^5rc_stat©in©nt:; 

Widgetl D,Re$oureelD: Value 

action_section;: 

[ act njstatment... ] 

actio n_state nna nt: : 

Wldg©HD[.ActionTypeJ: action 

action;: 

singte^aotionl mult!_acffon 

aingte^action:: 

CallbacklD l<resrc_s4^ternertt> I inaction 

inaction:: IF (CailbacklD) THEN action [ ELSE action ] 

multi_ac£iQn;;{acta... } 



FIG. 8(a) 
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WidgetID;: string 
WidgetClass:: string 
ResourcelD:: string 
Value:: string 
ActionType:: string 
CaltbackID:: string 

1 . [x] means x can be omitted 

2. x.,. means k can be repeated 

3. x/y means xory 

4. "LAYOUT, "RESOURCE" and "ACTION" are pre-deflned keywords. 

5 . "ROOT' is a predefl ned Widg etl D 



FIG. 8(b) 
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902 



904 

V 



# 
# 
# 



# 



Jtxx.conf 

Delivery Subsystem Configuration File 

Words in upper case are pre-defined keywords. 

syntax: 

LAYOUT: 

parentWidgetlD.widgetClass: [wldgetjd I 
widgaUd(suhwldgetlD,..) J 

RESOURCE: 

widgeHd. resource: value 
ACTION: 

widgetjd: [caIlbackID(widgetJd.,.) I 
<widgetjd resource: 



LAYOUT 

ROOT.actionW; 



vafue> J 



action 1(\ 

actio n2(acJ2 = 1, aci2j2), \ 
action^ \ 
actio n4(\ 

act4_1, act4_2, ac*4_3t\ 
act4_3_1>\ 

)\ 



) 

# ROOT, action W: helpl 

ROOT.shortEjcclusiveLisW: menul 

ROOT.browseirW browserl 



RESOURCE 

acfioni1,CVVilabel: 

action2.CW9abeE: 

action3.CWiabeE: 

sci2_1 .CWIabe!: 
& helpl. cwiabel: 
& ROOT.CWmessage: mmmmmm 
# menul.CWiabeD: Media 
& browser"! .CWlalbel: Deliverables 



Deliver 

Change Meg Area 
QUIT 
ACTS 1 
HELP ME 



#INPUT: 

# menul: dataList 

# browserl : dataTree 
# 



Example Configuation Info 
FIG. 9(a) 
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^OUTPUT: 

# menul: 

# browser! : 



data 
dataList 



# 

# p.s. Showing INPUT and OUTPUT sections here la for your information 
only. Users can not change the pre-defined input and output typss of 



L&F Agent will not recognize INPUT and OUTPUT commands. 

'action 

act2 J: IF (delivarCB) THEN \ 

<ROOT.CWmesaage: hello> 

sci2_2: IF (deliveiCB) THEN ^ 

<ROOT.CWm«sssage: hello* \ 
ELSE { <ROOT,CWmessage: wortd> actCB2 } 
action^ quite B 

& act2_1: quite B 




ih& composite widgets 



Example Configuration Information 
FfG. 9(b) 
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CWObj 





CWMainiFrams 






CWTextMsgD 






CWPullMenu 






CWM«nu 

i 





A 



CWBrowsar 



CWRowColumn 



CWMessage 



CWTextEdif 



CWSelRadioD 



CWShortList 



CWHierarchyBrowae r 



^ CWListBrow&er 



Composite Object Class Hierarchy 
FIG. 10 
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Composite Widget #1 (Lets User select one of a group of choices) 

CWIndows version) 



1102 



Receive from the LOM 
arguments for the member 
function of thts object 
invoked by the LOM 



[n current widow, output 
each choice wrth a $maJf 
circle next to It (see Fig, 12} 



110fl 



1108 



Let user select one of the 
choices and fid in the circle 
next to the user's choice 



Once the use^s choice is 
final when the user 
presses the right mouse 
button or double clicks), 
return the user's choice to 
the LOM 



v member 
f functfon 



FIG. 11 
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12D2 < 



FIG, 12 (a) 
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era 




D 



□ Kit Deferar"! 


I hi© t r 


Lteiirar 


"I 

Floppy (/dwrtrfdO) i 
Floppy (/dav/rfdtia) i 
Floppy (/dev/rfdOb) [ 
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Close 





RG. 12(b) 
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Composite Widget #2 (Lets User select one of a group of choices) 

(Text version) 



1302 



Receive tfrom the LOM 
arguments for the member 
function of thie object 
invoked by the LOM 



1304 



On view screen, output 
each choice and highlight 
d ©fault choice (see Fig. 14) 



1306 

SI 



Highlight each choice as 
the user moves the cursor 
over it 



member 
function 



130B 



Once the user's choice lis 
final (e.g., when he hits the 
return key), return Ihe user's 
choice to the LOM 



J 



FIG, 13 



2B 



EPO 7&&G34A1 



110 





Move cursor to make choice and press enter: 




Flippy f/<iav/rfdO> j 




Floppy (/detfrfdOa) 




Floppy (/dew'rfdOb) 




Floppy (/dev/rWOc) 


1402 < 


Tape (/dev/rat12) 




Tape iydev;rat20) 




Tape (/devyrst28} 




Tape (WeWret-*) 




email 




File 




enter fJJer>ame> 





FIG. 14 
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// 

// CWMalnframe.h: TTiis is the Mainframe window for all subsystems. 

1/ It contains, menubar, body and footer messag© area. 

U Resources that yoii can change Is only for Form Vtf dgat. 

// (Resources for Form wJdg©t6 should bo specified from this. 

!) children of Form Widget) 

#lfndef_CWOB J_C WMA1 MFRAMEH H 
«efine_CWOBJ_CWMAINFRAME "HH 
#incud© "CWObj.hh" 
^include "MfiNString.hh" 

struct CWWIafrtframeP ; // forward declaration 
struct PopupData; 

include "qUaLMi" 

struct rn©nuTro&{ 

HSNString label; //label string 

JtSWString mnemonic; //label mnemonic 

11 8 N String accelerator //acoetergtor 

11 9 N String accelsratorTiaxt; //acceteratorText 

void (*cb) (void*); i/cb to be registered ' 

//—define your own type 

void fl eb_data; tfealLdafa added 9/14/94 

static const int opjd; U 

static MenuTree* decode(char* s t ehar*&te) { return NULL; } ; 
void encode (eft a r*& bttf. JniS len) const G> 

>; 

enum Fopup_Statu8_m.ode {Ok, //ok btn prwwd 

Cancel //cancer buitton pressed 

}; 

class ONMainframe : public CWObf { 
public: 

CWMa]nfram©(const char °) ; //User: instance name 

-CWMainframsQ ; 

void ImatanltiatB^help^pairiel () ; 

void open_help 0 ; 

void Gloaejielp 0 ; 

void write Jie!pJext(const i18NStrirbg&) ; 
void create r3 pulldDwn{QList<Menu:Tree>&) ;//User:cb regisiration will be down 

// Inscde here.. 

// User use this to add pulldown 
//menu like "File 0 
//The methods which override CWObj msthods. 
XMAppllcatfonShell *g«tjDpfeud() ; 

Composite Widget 
FIG. 16(a) 
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XMObJect *g©t_par©ntConiafner(); 

vofd sst^rigMJ^cter jmeaasgefll 8MStrln& &} ; 

vefd aetjsft^ofer jinieasagefl 1 SNString &) ; ! 

void setJranneTiftefll 8NSfrfng &} ; 

//popup panels for warning/text tntrtezJmmftttfflffflfWM 
void setjjkpopdownfPapupData 
//use thfe for popping up any warning messages 
//Only has OK button 

void popup_warnin$fl18NStrtng &) ; 

//use papup_pirompt whan you want user to type 

//in th* entry such as file narna 

//Has both OK and Cancel button 
void popup_prompt(l 1 SNString &)i 

void 6et_popupfi©ld_cont©nt(char *) ;//CVV onfy 

void popdown ^promptQ ; //call this to popdown the popup 
void j^g j>mmpt_ok_cb(vold(*<*)(vold*) l( void *clfent_dsta) 

void regjjrpmpt^eanceLcbCvoldf^cbXvold*), void 

"dienlLdata); 

H9NString * ge<f_pronript_contentO ; //output 

//us© this to display error message 
//Only displays OK button 

vcJd popup_errcr{ll1SNS&ing &) ; 

//WorWngfbu&y} Popupfl/fflfft/M/iiMM 
// MO button 

// Popdown when procass is complete 

mmwMMMitfwwwm 

void popup_working{) : 

void popdovrnj^orklngO; 

//Question pQpupfmmMtfffftfflffttfttf 

//uss this to ask user a question 

//Has both OK and Cancel button 

void popup_quesiion(l18NSir!fig &) ; 

void reg_qu©stion_ok_cb(void(' > cb)(vDid void 'client^data) ; 

void reg_question_canc©l_cb(void(*cb) (void , void 

*clientjdata) ; 

void papdawn^questlonO; 
//used nnfy in CW 

void 6et_stetus{Popup_SbrtU5_mod©,PopupData *) ; 

//return if user selected OK or eance! btn ' 
Boolean get_$fcatus() ; 

Com posit© Widgst 
FIG, 15(b) 
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//use this button If you want to glvs some 
//friendly info to the user 
//Has OK button 

void popupjnfb(ll8NString &) ; 

//Se lection Popu ^mmmmmmmmm 

tflist selection choices 

if contains OK and Cancel buttons 

void popup_s©5ection(QList<f 1 8NString> &} ; 

void reg_se!ect_ok_cb(void(*cb) (vofd *) , void *clientjiata); 

void reg-s©Jeot_canG&l_cb{vo3dCcb) (void *). vofd 

*cli©rrt_data) ; 
void popdown_se[ecfion() \ 

void seS_$electedV&lu« (XmSefeciionBoaCallbacfcStrutf °) ; 

//CW use onty 
HSNSfrfng * get_selecfedltem() 

//Dou bieTextf p opupmf//m/ff/twfmii/m/mi//f//ff/ 

//Two input area : use It fertile and director/ type of inputs 
// It comes with cancet and ok btn 

// You can set up message area using setjmsgBody(H SWString &} 
void pop_doubteTextf(QUst<tT8NString>&) ; 

void popdown_doubt©TextQ; 
void reg^doubletext^cancel^cbO/oidCcb) (void*) , 

void *client_data); 
vofd reg_doubfetext_ok_ck(void(*cb) (void''} , 

void *client o data) ; 
void set^msg Body (i 1 SNStri n g &) ; 

QList<l1fiNString> * gef doubleFleldsQ ; 



Composite Widget 
FIG. 15(c) 
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//cwf \\ep\fMmmuuMimnumttiummimmuu 

void reg_fite_cancel_cb(void(* ! cb) (void*) , void *elient_data} 

void regjfire~ok_cbCvoidCcb) (void*) . void *eHetrt_data) ; 

void popup_filepick 0 ; 

void popdown_fi1epick 0 ; 

void set-d*fault_path (H8NSfrlng &) ; 

MeNStrtng * get_*election<) ; 

private: 

CWMainframeP *p; 

void set_menu Items {QLlstlter<fvlenuTre«>, void*) : 
void Instantiate^ rompt^panelQ; 
void Instantiate.^ uestlon_panelQ ; 
void lnstantlate_doubteTextfO ; 
void lnstantfate_sel_box() ; 

}; 

#endif // CWOBJ CWMA1N FRAME HH 



Composite Widget 
FIG. 15(d) 
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